home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / misc / emu / anonymous.readme < prev    next >
Text File  |  1998-10-31  |  10KB  |  240 lines
  1. Short:    Bug fixed SPC-700 emulator preview
  2. Author:   chinoclast@mailexcite.com (Gaelan Griffin)
  3. Uploader: chinoclast@mailexcite.com (Gaelan Griffin)
  4. Type:     misc/emu
  5. Requires: An 020+ amiga, AHI version 4 or greater: mus/misc/ahiusr.lha
  6. Replaces: misc/emu/Anonymous.lha
  7.  
  8. Cool copyright routine, use it in your own code :D
  9.  
  10.  
  11. ----------------------------Licensing Agreement-----------------------------
  12.  
  13. All files Copyright (c) 1998 by Gaelan Griffin.  All rights reserved.
  14.  
  15. License Agreement
  16.  
  17. This license applies to the computer program known as "Anonymous", which is
  18. referred to in this license as the "program".
  19.  
  20. The "author" refers to Gaelan Griffin who is the author of the program,
  21. documentation, and any related files and who has copyrighted (1998) all the
  22. files mentioned.
  23.  
  24. The "archive" refers to the package of distribution, as prepared by the
  25. author.
  26.  
  27. Each licensee is addressed as "you" or the "licensee".
  28.  
  29.  
  30. All conditions of this licensing agreement stated below must be met.
  31.  
  32.  
  33. You can not challenge the author's copyright.
  34.  
  35. No profit can be gained directly or indirectly by the licensee as a result
  36. of the use of or failure to use the program without the prior written
  37. permission of the author.
  38.  
  39. The program can not be used in any way that directly or indirectly supports
  40. the Microsoft corporation or any of it's subsidiaries or business partners
  41. without the author's prior written permission.
  42.  
  43. The program can not be used by any employee or shareholder of the Microsoft
  44. corportation or any of it's subsidiares or business partners without the
  45. author's prior written permission.
  46.  
  47.  
  48.  
  49. The program and the data in the archive are freely distributable under the
  50. restrictions stated below, but are also Copyright (c) 1998 by Gaelan Griffin.
  51. All rights reserved.
  52.  
  53.  
  54. Redistribution of a modified version of the program, the archive or the
  55. contents of the archive is prohibited in any way, by any organization,
  56. regardless whether commercial or non-commercial. Everything must be kept
  57. together, in the original and unmodified form.
  58.  
  59. Commercial distribution or inclusion of the software in any collection
  60. including, but not limited to, CD-ROMS or cover disks is forbidden without
  61. the author's prior written permission with the sole exception of Aminet and
  62. Fred Fish CD-ROMS.  The exception previously stated is only applicable as
  63. long as the author does not state otherwise and as long as all conditions
  64. of the licensing agreement are met.
  65.  
  66. Distribution may not violate the licensing agreement or copyright in any way.
  67.  
  68. A nominal fee to cover copying costs is allowed.
  69.  
  70.  
  71.  
  72.    THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  73. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  74. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  75. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  76. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM AND ALL RELATED FILES
  77. IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
  78. ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  79.  
  80.  
  81.    IN NO EVENT WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY 
  82. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR ANY
  83. DAMAGES, INCLUDING, BUT NOT LIMITED TO, ANY GENERAL, SPECIAL, INCIDENTAL OR
  84. CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
  85. PROGRAM INCLUDING, BUT NOT LIMITED TO, LOSS OF DATA OR DATA BEING RENDERED 
  86. INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE
  87. PROGRAMS TO OPERATE WITH ANY OTHER PROGRAMS EVEN IF SUCH HOLDER OR OTHER
  88. PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  89.  
  90.  
  91.  
  92. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  93. AND ALL DATA CONTAINED IN THE ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT
  94. THIS LICENCE BY USING THE PROGRAM AND/OR REDISTRIBUTING THE ARCHIVE OR ANY
  95. DATA CONTAINED WITHIN THE ARCHIVE.
  96.  
  97. --------------------------End of Licensing Agreement------------------------
  98.  
  99. No time for proper docs yet (I think I spent WAY too much time on the
  100. Licensing Agreement :) but you can't be too careful in today's society.)
  101. I'll just cover the main points
  102.  
  103. As you know from reading the licensing agreement you don't have to pay any
  104. money for the use of this software.  Although it's possible that this may
  105. change in the future (emailware, giftware, maybe even shareware) I have no
  106. intention of ever crippling my programs or adding annoying features.  More
  107. on this later.
  108.  
  109.  
  110. Okay, this is the first "preview" release of my SPC-700 emulator.  I don't
  111. have as much time to work on it anymore for awhile and I promised some
  112. people that I would make a public release soon.  That, combined with the
  113. fact that the emulator works (sort of) with some programs and the new
  114. version of ADOM is the reason I've decided to release this.  Remember, this
  115. is a "preview" release.  It doesn't work very well yet.  It's primary
  116. purpose is to let the world know that it does exist and does work and also
  117. to give people something to look forward to in the future.
  118.  
  119.  
  120. Okay, I'll admit it, the sound is pretty terrible right now.  Most replays
  121. don't work and the ones that do usually don't sound too good (although some
  122. DO sound nearly perfect.)  That's why this is only a "preview" :)  You may
  123. notice that some replays partially work and you can make out a tune.  This
  124. is evidence that most parts of the emulation are working okay.  I'm aware
  125. of many of the problems and am working to fix them when I have time.
  126.  
  127. In other words, please DON'T COMPLAIN about the sound or I will not release
  128. this again until it is nearly perfect.  Okay?
  129.  
  130.  
  131. The next version will have real documentation in which I will give a
  132. detailed description of the emulator status and what to expect in the
  133. future.
  134.  
  135.  
  136.  
  137. Usage:
  138.  
  139. You need AHI installed.  At the command line type
  140.  
  141. Anonymous file
  142.  
  143. where file is the name of the .SPC file to emulate.  Simple.
  144.  
  145. Yes, it's called Anonymous.  This is because I haven't been able to decide
  146. yet between the many names I'm considering.  Suggestions are welcome.
  147.  
  148. To quit, type Ctrl-C in the shell window.  Because of the AHI mixing
  149. routines, the output will be very soft so turn up your monitor/speakers and
  150. please don't forget to turn them down again when you are finished.  This
  151. will be fixed in the future.  It uses minimal stack.  Don't try to run it
  152. from the workbench.  That's about it.
  153.  
  154.  
  155. Solutions to some problems you may have:
  156.  
  157. Adjust AHI settings, especially the default music unit.  Try setting it to
  158. one of the 8-bit fast modes (NOT ++)
  159.  
  160. Try to give it as much CPU time as possible.
  161.  
  162. Sometimes you have wait a few seconds with some .spc files.
  163.  
  164. Try a different SPC :)  In particular, try the recommended ones.
  165.  
  166.  
  167. About the .SPC files:
  168.  
  169. These are SPC-700 emulation save states, written out by some program
  170. (usually ZSNES.)  Personally, I find this method to be very poor, but at the
  171. moment, there is no other way.  I'm working on a file format for ripped
  172. music which will be MUCH better than stupid save states, but it will be
  173. awhile.  If you're interested in ripping, mail me.  More on this later.
  174.  
  175.  
  176.  
  177. Known bugs:
  178.  
  179. There is a small memory loss the first time the program is run.  I believe
  180. this is AHI's fault as I've seen other programs exhibit this behaviour.
  181. This mem loss is small and is one-time only so it shouldn't affect anyone.
  182. I don't know if it can be fixed.
  183.  
  184. The second time the program is run there will be 2 byte reads from 1E.
  185. This appears to be caused by AHI_SetSound loading a null pointer from
  186. somewhere.  I haven't seen this in other programs so it's probably my fault.
  187. I probably passed some bad data in the AHI initialization code somewhere.
  188. It appears to be harmless.  If you have any idea why this might be happening,
  189. let me know.
  190.  
  191. Other than that, it appears to be pretty stable.  If you notice any
  192. enforcer or mungwall hits (besides the ones listed above) then let me know.
  193. Also, inform me immediately if it ever crashes, don't assume someone else
  194. will.  Be sure to try and troubleshoot the problem first (get rid of
  195. patches, upgrade AHI, use different audio mode, boot without startup sequnce)
  196. When reporting bugs, be sure to give me as much information about your system
  197. and